home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / misc / apple2000v13.lha / Apple2000_Utilities / disk2file.doc < prev   
Text File  |  1994-08-18  |  4KB  |  109 lines
  1.                               Disk2File
  2.                    An Apple ][ DOS 3.3 Disk Reader
  3.                             By Ron Menelli
  4.  
  5.               Copyright (c) 1992,1994 Ronald J. Menelli
  6.  
  7.  
  8. This program is copyrighted but freely redistributable. Distribute it
  9. as you like, as long as the package is distributed as an unmodified
  10. whole.
  11.  
  12.  
  13. INTRODUCTION
  14.  
  15. Disk2File is a program that simply reads an Apple ][ DOS 3.3 formatted
  16. 5 1/4" disk and writes the entire contents of the disk to an AmigaDOS
  17. file.
  18.  
  19.  
  20. SYSTEM REQUIREMENTS
  21.  
  22. Disk2File runs on any Amiga computer that has an Amiga 1020 or
  23. equivalent 5 1/4" drive. At the time of this writing, Disk2File has
  24. only been tested on an A3000-25 with AmigaDOS 3.1 and an Amiga 1020
  25. drive.
  26.  
  27.  
  28. USAGE
  29.  
  30. To run this program, put your Apple ][ disk in your Amiga 5 1/4" drive
  31. and, in a shell window, type:
  32.  
  33.         Disk2File DFx: file_name
  34.  
  35. Where DFx: is one of DF0:, DF1:, DF2:, DF3: (whichever your 5 1/4"
  36. drive is) and file_name is the desired output file name. Provided
  37. there are no read errors, the data on the disk will be copied to the
  38. Amiga file.
  39.  
  40. OPTIONS
  41.  
  42. As of version 1.2, Disk2File now allows options to be added after the
  43. file name. These options are as follows:
  44.  
  45.     -debug      Enable debug mode
  46.     -start n    Select starting track        (default is 0)
  47.     -end n      Select ending track          (default is 34)
  48.     -step n     Select track step increment  (default is 1)
  49.  
  50. The -debug option simply forces the program to print a hex dump of any
  51. track that causes a read or decode error. This is helpful if you
  52. happen to understand the layout of Apple DOS 3.3 disks and your disk
  53. won't read correctly.
  54.  
  55. The other three options control what portion of the disk should be
  56. read. If you have a 1020 or other 40 track 5 1/4" drive, you probably
  57. won't need to use these options. However, a number of users have told
  58. me they have 80 track drives, which won't work with the default
  59. settings.
  60.  
  61. I don't have an 80 track drive to allow me to test this feature, but I
  62. believe that, on an 80 track drive, you would use the command:
  63.  
  64.     Disk2File DFx: file_name -start 0 -end 68 -step 2
  65.  
  66. to read a standard DOS 3.3 disk. Please let me know if this works
  67. correctly!
  68.  
  69. Please note that if, by choosing some combination of options, the
  70. resultant file is not 143,360 bytes long, it most likely won't work
  71. with your emulator. Be forewarned.
  72.  
  73. FILE FORMAT
  74.  
  75. The format of the output file is one that is used by a number of Apple
  76. ][ emulators. The data in the file is merely each sector of the disk
  77. written one after the other (in sequential order, not the order the
  78. sectors are stored on the disk), starting at track 0, sector 0. The data
  79. is completely decoded from its original GCR form, so no further
  80. conversion need be done by the emulator.
  81.  
  82.  
  83. VERSION HISTORY
  84.  
  85. 1.2   8/17/94   Added the -start, -end, and -step options to allow the
  86.                 use of 80 track drives and to give more control over
  87.                 what's going on.
  88.                 Added the -debug option to print hexdumps of tracks
  89.                 when errors are detected.
  90.                 Fixed an amazingly silly bug that caused the program
  91.                 to lockup or crash when a non Apple DOS disk was read.
  92.  
  93. 1.1   5/19/94   Fixed a number of silly decoding bugs that didn't
  94.                 appear until now. Added full checking of markers and
  95.                 checksums.
  96.                 First public release.
  97.  
  98. 1.0             First try - basic functionality.
  99.  
  100.  
  101.  
  102. Please send bug reports, complaints, suggestions, beer and moral
  103. support to:
  104.  
  105.         menelli@uiuc.edu
  106.  
  107. Ron Menelli
  108. August 17, 1994
  109.